Node / meshtastic / Meshtastic-Android / files / core / ble / src / commonMain / kotlin / org / meshtastic / core / ble / MeshtasticBleDevice.kt

Displaying Raw • Download

T8b949e/*

* Copyright (c) 2026 Meshtastic LLC

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tff7b72package T7ee787org.meshtastic.core.ble

Tff7b72import T7ee787com.juul.kable.Advertisement

Tff7b72import T7ee787com.juul.kable.ExperimentalKableApi

Tff7b72import T7ee787kotlinx.coroutines.flow.MutableStateFlow

Tff7b72import T7ee787kotlinx.coroutines.flow.StateFlow

Tff7b72import T7ee787kotlinx.coroutines.flow.asStateFlow

T8b949e/**

* Unified [BleDevice] implementation for all BLE devices — scanned, bonded, or both.

*

* When created from a live BLE scan, [advertisement] is populated and used for optimal peripheral construction via

* `Peripheral(advertisement)` with a direct (non-autoConnect) connection attempt.

*

* Bonded-only devices (address only, [advertisement] null) can still be constructed for display in the device list and

* as a bounded fallback when fresh scans miss. In that fallback, Kable creates an address-only peripheral so Android

* can wait for the device to advertise through its `autoConnect` path while the transport keeps the connection attempt

* bounded.

*

* @param address The device's MAC address (or platform identifier string).

* @param name The device's display name, if known.

* @param advertisement The Kable [Advertisement] from a live scan, or `null` for bonded-only devices.

*/

Tff7b72class T56d364MeshtasticBleDeviceTb4b4b4(

Tff7b72override Tff7b72val Te6edf3addressTb4b4b4: Tffa657StringTb4b4b4,

Tff7b72override Tff7b72val Te6edf3nameTb4b4b4: Tffa657String? Tff7b72= Tff7b72nullTb4b4b4,

Tff7b72val Te6edf3advertisementTb4b4b4: Te6edf3Advertisement? Tff7b72= Tff7b72nullTb4b4b4,

Tb4b4b4) Tb4b4b4: Te6edf3BleDevice Tb4b4b4{

Tff7b72private Tff7b72val Te6edf3_state Tff7b72= Te6edf3MutableStateFlowTff7b72<Te6edf3BleConnectionStateTff7b72>Tb4b4b4(Te6edf3BleConnectionStateTb4b4b4.Te6edf3DisconnectedTb4b4b4(Tb4b4b4)Tb4b4b4)

Tff7b72override Tff7b72val Te6edf3stateTb4b4b4: Te6edf3StateFlowTff7b72<Te6edf3BleConnectionStateTff7b72> Tff7b72= Te6edf3_stateTb4b4b4.Te6edf3asStateFlowTb4b4b4(Tb4b4b4)

T8b949e// Bonding is handled by the OS pairing dialog on Android; on desktop Kable connects directly.

Tff7b72override Tff7b72val Te6edf3isBondedTb4b4b4: Tffa657Boolean Tff7b72= Tff7b72true

Tff7b72override Tff7b72val Te6edf3isConnectedTb4b4b4: Tffa657Boolean

Tff7b72getTb4b4b4(Tb4b4b4) Tff7b72= Te6edf3_stateTb4b4b4.Te6edf3value Tff7b72is Te6edf3BleConnectionStateTb4b4b4.Te6edf3Connected Tff7b72|Tff7b72| Te6edf3ActiveBleConnectionTb4b4b4.Te6edf3activeTff7b72?.Te6edf3address Tff7b72=Tff7b72= Te6edf3address

Tff7b72override Tff7b72val Te6edf3rssiTb4b4b4: Tffa657Int? Tff7b72= Te6edf3advertisementTff7b72?.Te6edf3rssi

Tf0883e@OptInTb4b4b4(Te6edf3ExperimentalKableApiTff7b72::Te6edf3classTb4b4b4)

Tff7b72override Tff7b72suspend Tff7b72fun Td2a8ffreadRssiTb4b4b4(Tb4b4b4)Tb4b4b4: Tffa657Int? Tb4b4b4{

Tff7b72val Te6edf3active Tff7b72= Te6edf3ActiveBleConnectionTb4b4b4.Te6edf3active

Tff7b72return Tff7b72if Tb4b4b4(Te6edf3active Tff7b72!Tff7b72= Tff7b72null Tff7b72&Tff7b72& Te6edf3activeTb4b4b4.Te6edf3address Tff7b72=Tff7b72= Te6edf3addressTb4b4b4) Tb4b4b4{

Te6edf3activeTb4b4b4.Te6edf3peripheralTb4b4b4.Te6edf3rssiTb4b4b4(Tb4b4b4)

Tb4b4b4} Tff7b72else Tb4b4b4{

Te6edf3advertisementTff7b72?.Te6edf3rssi

Tb4b4b4}

Tb4b4b4}

Tff7b72override Tff7b72suspend Tff7b72fun Td2a8ffbondTb4b4b4(Tb4b4b4) Tb4b4b4{

T8b949e// No-op: bonding is OS-managed on Android and not required on desktop.

Tb4b4b4}

T8b949e/** Updates the tracked connection state. Called by [KableBleConnection] when the peripheral state changes. */

Tff7b72internal Tff7b72fun Td2a8ffupdateStateTb4b4b4(Te6edf3newStateTb4b4b4: Te6edf3BleConnectionStateTb4b4b4) Tb4b4b4{

Te6edf3_stateTb4b4b4.Te6edf3value Tff7b72= Te6edf3newState

Tb4b4b4}

Tb4b4b4}